package com.ruoyi.wechat.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.wechat.domain.WxUser;
import me.chanjar.weixin.common.error.WxErrorException;

import java.util.List;
import java.util.Map;

/**
 * @Author: yan
 * @Description: 微信用户信息
 * @Date: 2022-07-18
 */
public interface WxUserService extends IService<WxUser> {
    /**
     * 分页查询用户数据
     * @param params 查询参数
     * @return PageUtils 分页结果
     */
    IPage<WxUser> queryPage(Map<String, Object> params);

    /**
     * 根据openid更新用户信息
     *
     * @param openid
     * @param appid
     * @return
     */
    WxUser refreshUserInfo(String openid, String appid);

    /**
     * 异步批量更新用户信息
     *
     * @param openidList
     */
    void refreshUserInfoAsync(String[] openidList, String appid);

    /**
     * 数据存在时更新，否则新增
     *
     * @param user
     */
    void updateOrInsert(WxUser user);

    /**
     * 取消关注，更新关注状态
     *
     * @param openid
     */
    void unsubscribe(String openid);

    /**
     * 同步用户列表
     *
     * @param appid
     */
    void syncWxUsers(String appid);

    /**
     * 通过传入的openid列表，同步用户列表
     *
     * @param openids
     */
    void syncWxUsers(List<String> openids, String appid);

    /**
     * 修改用户备注
     *
     * @param wxUser
     * @return 成功与否
     * @throws WxErrorException 微信异常
     */
    boolean updateRemark(WxUser wxUser) throws WxErrorException;

    /**
     * 认识标签
     *
     * @param taggingType 类型
     * @param tagId 标签ID
     * @param openIds openId
     * @throws WxErrorException 异常
     */
    void tagging(String taggingType, Long tagId, String[] openIds, String appId) throws WxErrorException;
}
